home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
timlok10.zip
/
TIMELOCK.DOC
< prev
next >
Wrap
Text File
|
1992-02-25
|
17KB
|
397 lines
TIMELOCK
THE TIME MANAGEMENT SYSTEM FOR BBS DOORS AND PROGRAMS
INTRODUCTION:
───────────────────────────────────────────────────────────────────
TimeLock is a simple, yet powerful TIME MANAGEMENT DOOR
PROGRAM for mail, game, and other doors on a Bulletin Board
System. It enables BBS Sysop's to control which individual
callers, or groups of callers, have access to Mail Doors, Game
Doors, and other BBS programs during specific times of the
day or night. Only designated callers (or groups) can enter
a door program during a Sysop defined time slot when the
correct password is provided
FOR NETMAIL HUBS
Netmail Hubs frequently find that HUBS and NODES call for
mail OUTSIDE their designated time slots. This, of course,
starts a domino effect. TimeLock ENSURES THAT NODES AND HUBS
CALLING YOU FOR THEIR MAIL CAN ONLY ACCESS YOUR MAIL DOORS
DURING THE TIMESLOT YOU DESIGNATE.
GAMES AND OTHER DOORS
TimeLock is great for controlling access to popular game doors
for tournaments or contests. Now you can designate what
callers have access to particular GAME DOORS during the hours
and times you designate.
HOW TIMELOCK WORKS:
───────────────────────────────────────────────────────────────────
TimeLock.EXE can be placed in any door batch file prior to the
command that actually calls or opens the door. When a caller
attempts to open a TimeLock protected door, TimeLock is
executed first and retrieves a password. The password maybe
retrieved by user entry or from the DOOR.SYS file. If the
password is valid for the current time slot, then TimeLock
returns an errorlevel which can be used to allow the caller to
continue and run the door program. If the password is not
valid for the current timeslot, an errorlevel is returned that
can be used to return to the board without opening or
executing the protected door program.
SUMMARY TIMELOCK FEATURES:
───────────────────────────────────────────────────────────────────
* Allows Bulletin Board Sysops to restrict access to MAIL, GAME
and other doors using Sysop defined timeslots.
* Written for PC Board, GAP, Wildcat and any BBS that produces a
DOOR.SYS.
* Multi-Node Operation (Registered Version).
* Overlapping timeslots with verification (Registered Version).
* Usage log (Registered Version).
* User definable default time slot increments (Registered Version).
* Can retrieve password from DOOR.SYS (Registered Version) or
request password to be entered.
( -1- )
TIMELOCK and TIMEDATA:
───────────────────────────────────────────────────────────────────
The TIMEDATA.EXE Program
TimeData allows you to create a database containing a starting
and ending time (a Time Slot), a caller name or ID (this can
be a HUB or Node ID or a users name), and a password as
shown below. Note that the caller id field is for your
reference only. The password and current time are all that are
used to determine whether the errorlevel should be set.
Sample TimeData screen:
────────────────────────────────────────────────────────────────
| START | END | Caller ID | Password |
────────────────────────────────────────────────────────────────
20:00 20:15 HUBWOCKY XYZ123
20:15 20:30 THDOOR WEBSTER
20:30 21:00 HUBNY ALPHA
20:55 21:20 HUBWEX SARAJ
The TIMELOCK.EXE Program
TimeLock checks the database when the caller tries to open a
door or execute a program protected by TimeLock. If the
password provided (either thru entry or from the DOOR.SYS file)
is valid for the current timeslot, then TimeLock returns an
errorlevel of 0. If an incorrect password is provided,
TimeLock returns an errorlevel or 255. By testing for these
errorlevels in your door batch files, you can grant or deny
access to the program or door.
EXAMPLE: USING TIMELOCK FOR A HUB MAIL DOOR
───────────────────────────────────────────────────────────────────
Suppose that you want to use TimeLock to protect your HUBS and
NODES time slots, ensuring that only those designated can call
in and get their mail during their time slot.
Example: HUBRIME.BAT
echo off
Timelock
If errorlevel = 255 goto end
If errorlevel = 0 goto mail
:mail
F:
cd F:\RIME\HUB
rem run the HUB with the proper configuration file
HUB CONFIG3.HUB REMOTE
:end
In the above example, when the Node or HUB calls and opens
your Mail Door, TimeLock either requests or retrieves a
password. If the password is correct for the current timeslot,
an errorlevel of 0 is returned and the batch file allows the
caller to open the mail door. If the password is incorrect,
TimeLock returns an errorlevel of 255 and the caller is not
permitted to open the mail door.
( -2- )
INSTALLING & USING TIMELOCK:
───────────────────────────────────────────────────────────────────
TIMLOKxx.ZIP contains the following files:
TIMELOCK.EXE - Program that requests and verifies the
password entered.
TIMEDATA.EXE - Program that maintains the list of time
slots and their passwords.
TIMELOCK.CNF - Sample configuration file for TimeLock.
TIMEDATA.CNF - Sample configuration file for TimeData.
TIMELOCK.DOC - This file.
To install TimeLock, follow the steps listed below.
STEP 1. Make a directory for the TimeLock programs and files. If
you are using an unregistered version, you will need to make
one directory for each node that you wish to run TimeLock
on or you can place the TimeLock files in each nodes default
directory. Registered users may make one area regardless of
the number of nodes.
STEP 2. Make configuration files. You may use the sample files
(TIMELOCK.CNF & TIMEDATA.CNF) for this purpose. Each TimeLock
configuration file will contain five (5) lines as follows.
e:\node4 <== Path to system files
The Door <== BBS Name
0 <== 0=Gap/1=PC Board & Everything else
N <== Maintain Usage file? Y/N
Y <== Get password from DOOR.SYS? Y/N
The TIMEDATA.CNF file will contain one (1) line as follows.
5 <== Default Time Increment in Minutes
For more information about the configuration files, please view
the sample TIMELOCK.CNF and TIMEDATA.CNF files provided.
STEP 3: Establish your time slot database using the TimeData
program. See page 4 for helpful hints on running this program.
STEP 4: Change the batch files used to run the doors you wish to
protect with TimeLock. (See the previous example.) Note that
if you are a registered user you may pass the configuration
file name that you wish to use on the command line. If this
configuration name is omitted the TimeLock program will use
the TIMELOCK.CNF file.
( -3- )
USING TIMEDATA
───────────────────────────────────────────────────────────────────
The TimeData program allows you to establish the database of time
slots and which passwords will activate them. Note that you may
enter the Caller Name, Hub Name, or Node ID in the Caller ID field.
However, the ID field is for your reference only and plays no
part in determining whether the password provided is valid.
Remember, if you are a registered user and you wish to establish
default time increments, then view and modify the TIMEDATA.CNF file
accordingly. If you do not wish to establish Default Time
increments, simply delete the TIMEDATA.CNF file.
The TimeData program is very straight forward and easy to use.
However, a few helpful hints never hurt.
1. To select a menu item you may use your arrow keys, or press the
first letter of the item. Note that PAGE UP will function as
Previous, PAGE DOWN will function as Next and ESC will function
as Quit. The ESC key will also abort the Adding & Changing
functions and return to the menu.
2. When the program requests a Yes or No response, the default
answer will appear in uppercase. For example, by pressing Enter
at the "Is this Correct? Y/n" prompt you would be selecting the
uppercase response, or "Y".
3. Your arrow keys work in moving around the screen and the menu,
but do not work well in editing. So when you are changing a
field, use your backspace key.
4. Times will be entered as hhmm, with no colon, it will be added
for you. Make sure you pad your entries with zeros (i.e. 0500)
and use a 24 hour clock.
5. If you established a default time slot length, you will not
need to enter an Ending Time, just press enter and TimeData
will enter it for you.
( -4- )
LEGALITIES
───────────────────────────────────────────────────────────────────
DISTRIBUTION
TimeLock is distributed in 2 forms. The DEMONSTRATION VERSION
which has some features partially enabled and, the REGISTERED
VERSION which is fully functional and has some added features.
The DEMONSTRATION VERSION of TimeLock may be freely
distributed and is provided for EVALUATION purposes. To obtain
a registered version of TimeLock, you should send $15.00 US
dollars plus $2.50 for postage and handling or you may
register TimeLock online using VISA or MASTERCARD by calling
The DOOR BBS & Information Network at the number listed below.
The DOOR BBS & Information Network
5-Nodes US Robotics DS/V.32bis/HST
407-682-3132
Peiman & Associates Inc.
629 Peachwood Drive
Altamonte Springs, FL. 32714
As a registered user, you will receive:
o The right to continue using TimeLock
o The latest version of TimeLock
o Updates for 1 Year
o Additional Program Features
o Technical support via The DOOR BBS, (407-682-3132)
COPYRIGHT NOTICE
This software and accompanying documentation are Copyright (c)
1991 by Peiman & Associates Inc.. All rights are reserved.
LIABILITY LIMITATION
Peiman & Associates, Inc., (PAI) does not assume any liability
for the use of TimeLock beyond the original purchase price of
the software. In no event will PAI be liable to you for
additional damages, including, but not limited to, any lost
profits, lost savings or other incidental or consequential
damages arising out of the use of or inability to use this
program, even if PAI has been advised of the possibility of
such damages. By using this software, you agree to the terms
of this section. If you don't agree, immediately cease use of
and return the entire TimeLock package for a refund.
LICENSE AGREEMENT
You are hereby granted a limited license to evaluate TimeLock
period not to exceed 30 days.
TRADEMARKS
All PAI Software products are trademarks or registered
trademarks of Peiman & Associates Inc.. Other brand and
product names are trademarks or registered trademarks of their
respective holders.
REPORTING PROBLEMS
If you encounter any problems with TimeLock which you think
might be a bug, please report it to us at the address above,
or contact us on the DOOR BBS.
( -5- )
REGISTRATION FORM
───────────────────────────────────────────────────────────────────
Registration Fee $15.00 $ ____________
Shipping & Handling $ 2.50 $ ____________
---------------
Total $ ____________
I wish to pay by
[__] Check - Make payable and send to Peiman & Associates, Inc.
at Post Office Box 948219, Maitland, Florida, 32794.
[__] Credit Card - Fill in the credit card information below.
We will either send the registered version or you can download it along
with your registration key file from, The DOOR BBS, (Tm) & Information
Network at 407-682-3132, (3-Nodes, USR DS/V.32bis/HST).
Please Check the Appropriate box:
[__] I wish my copy sent via US Mail. Pick one of the
following medias ( ___ 5.25" ___ 3.5" )
[__] I wish to download my copy.
Complete ALL of the following information:
Sysop Name: _____________________________________________
Board Name: _____________________________________________
address: _____________________________________________
_____________________________________________
City: _____________________________________________
State: ___________ ZIP: ___________ Phone: ___________________
(For Downloads Only)
Username: ___________________________________________
Password: ___________________________________________
(For Credit Card Purchases)
Name : _____________________________________________________________
(as it appears on your credit card)
Type of Card : ___ Mastercard ___ Visa ___ Diner's Club
___ Carte Blanche
Exp Date : ______ Issuing Bank : ________________________________
Signature : ________________________________________________________